Opaque data that will be passed back to the event handler when an event is raised.
destinationFolder
An AbstractFolder object into which the folder's content must be copied. Cannot be NULL.
recursive
true if the content of the folders contained in the subfolders should be copied; false if only the current folder's content should be copied.
replaceExistingFiles
true if existing files in the destination should be replaced; false otherwise.
filters
An array of objects that can be used to filter the items to be copied.
Remarks
If the physical folder specified by destinationFolder does not exist, it is created.
The difference between CopyFilesTo() and CopyItemsTo() is how empty sub-folders are handled. CopyFilesTo() only includes files and files found in sub-folders in the copy operation while CopyItemsTo() includes empty sub-folders in the copy operation. Unless you specifically want to copy empty folders, it is best to use CopyFilesTo().
The folder's content (files and subfolders) that matches the provided filters is immediately copied to the destination.
When replacingExistingFiles is true, any file in the destination that has the same name as a file being copied is automatically replaced.
When replacingExistingFiles is false, an exception is thrown whenever the destination contains a file with the same name as a file being copied.
To filter a list of files or folders, you can pass a variable number of objects in the filters parameter. These objects may be of the following types:
The string is assumed to be a file mask, and a NameFilter object is automatically created for the passed string, with FilterScope.File as the default FilterScope.
Each object in the array may be of the types described in this table, and is used accordingly.
Other
If any other type is found, an exception is thrown.
FileSystemItem.ApplyPropertiesTo is called on the destination items; therefore, the attributes and dates of the original items are applied to the destination items.